home *** CD-ROM | disk | FTP | other *** search
Text File | 2000-07-07 | 9.6 KB | 159 lines | [ TEXT/ttxt]
This document explains some of the details of the current AppleScript implementation Release: CDFinder 2.8.1 Future versions will include even more support. If you have suggestions, please let me know! =========================================================== The new version 2.8.1 of CDFinder has again an extended AppleScript ability. It is now possible to access the basic catalog and catalog folder info in a real object structured manner. Here is the new part of the dictionary. In addition, the preferences section contains two new properties that contain the number of catalogs and catalog folders. I know, I should have included a count command, but the implementation of it was much more complicated than I thought and I will add it in a later version. As you can see, you can change the name, the comment, the label, and the selection of a catalog and also a catalog folder. It is also possible to open or close a catalog folder by changing the is open property. The actual contents of a catalog will be revealed in a later version! A new event will reveal a catalog or catalog folder in the main window. That event will of course later be used for other classes, too. Starting with 2.8.1, this now includes Found Items. show: Bring an object into view show reference -- The object to be made visible =========================================================== Class catalog: one catalog file Plural form: catalogs Properties: ID integer [r/o] -- unique ID of this catalog. Only valid during one run of CDFinder! name text -- the name of the catalog as the user sees it volume name text [r/o] -- name of the original volume file name text [r/o] -- name of the actual catalog file, usually the same a the name of the catalog comment text -- the comment that the user has entered label small integer -- the label of the catalog. 0 is none filenumber integer [r/o] -- number of files in the catalog foldernumber integer [r/o] -- number of folders in the catalog volume size integer [r/o] -- the size of the volume in KB free space integer [r/o] -- the free space on that volume in KB formatted date [r/o] -- the date and time when the volume was formatted (created) modified date [r/o] -- the date and time when the volume was last modified catalog created date [r/o] -- the creation date and time of this catalog catalog folder ID integer [r/o] -- The ID of the catalog folder that contains this catalog. Is zero if the catalog lies in the top level. selected boolean -- is the catalog selected in the main window? Class catalog folder: a folder that contains catalog files Plural form: catalog folders Properties: name text -- the name of the catalog folder comment text -- the user comment ID integer [r/o] -- the ID of this catalog folder. Unique duringe one run of CDFinder. label small integer -- The label of this catalog folder created date [r/o] -- The date and time of the creation of this catalog folder. modified date [r/o] -- The date and time of the last modification of this catalog folder is open boolean -- Is this catalog folder open? selected boolean -- is the catalog folder selected in the main window? Class found item : an item in the Found Items window Properties: ID integer [r/o] -- the unique ID of this item. Only valid until a new Find operation is invoked! name text [r/o] -- the name of this item folder boolean [r/o] -- if true, the item is a folder, otherwise a file label small integer -- the label of this item created date [r/o] -- The date and time of the creation of this item modified date [r/o] -- The date and time of the last modification of this item size integer [r/o] -- the size of the file in KB, but of course only if it is a file! file type type class [r/o] -- the four character c of the item, if it is a file creator type type class [r/o] -- the four character creator code of the item, if it is a file catalogID integer [r/o] -- the ID of the catalog that contains this item. selected boolean -- is the item selected in the Found Items window? full path text [r/o] -- the full path of the found item =========================================================== Class application: CDFinder's preferences Elements: catalog by numeric index, by ID, by name catalog folder by numeric index, by ID, by name Properties: name international text [r/o] -- the application’s name frontmost boolean [r/o] -- Is CDFinder the frontmost process? version international text [r/o] -- the version of CDFinder global catalog folder alias -- an alias to the main catalog folder language Deutsch/English/Francais/Italian/Swedish/Chinese/Japanese -- the language of the user interface play sound boolean -- should CDFinder play a sound after long operations? label1 international text -- the name of label 1 label2 international text -- the name of label 2 label3 international text -- the name of label 3 label4 international text -- the name of label 4 label5 international text -- the name of label 5 label6 international text -- the name of label 6 label7 international text -- the name of label 7 main display size boolean -- display a column with the size of a volume in the main window main display unused boolean -- display a column with the unused space of a volume in the main window main display label boolean -- display a column with the label of a volume in the main window main display modification date boolean -- display a column with the modification date of a volume in the main window main display comment boolean -- display a column with the comment of a volume in the main window catalog display size boolean -- display a column with the size of an item in a catalog window catalog display filetype boolean -- display a column with the filetype of an item in a catalog window catalog display creator boolean -- display a column with the creator code of an item in a catalog window catalog display modification date boolean -- display a column with the modification date of an item in a catalog window catalog display creation date boolean -- display a column with the creation date of an item in a catalog window catalog display label boolean -- display a column with the label of an item in a catalog window catalog display icons boolean -- display the Finder icon of any item in a catalog window (slower!) catalog display catalog name boolean -- display a column with the catalog name of an item in the found items window ignore invisibles boolean -- creating a new catalog: ignore invisible files ignore icons boolean -- creating a new catalog: ignore icons files open StuffIt boolean -- creating a new catalog: open StuffIt files open CompactPro boolean -- creating a new catalog: open Compact Pro files catalog number integer [r/o] -- the number of catalog files catalog folder number integer [r/o] -- the number of catalog folders known to the application found items number integer [r/o] -- the number of items currently found =========================================================== find in: start a new Find operation find in all catalogs/selected catalogs/catalogs without label/catalogs with label 1/catalogs with label 2/catalogs with label 3/catalogs with label 4/catalogs with label 5/catalogs with label 6/catalogs with label 7/found items -- the selection of catalog files to be searched first kind theName/filetype/creator/size/creation date/modification date/label -- kind of first value to be found [first comparison fIs/fIsNot/fContains/fContainsNot/fBeginsWith/fEndsWith/fMoreThan/fLessThan/fEarlierThan/fLaterThan] -- how to compare the value first value reference -- find String, or filetype, or creator, or size or whatever [operator findAND/findOR] -- if two find values: how to combine them [second kind theName/filetype/creator/size/creation date/modification date/label] -- kind of second value to be found [second comparison fIs/fIsNot/fContains/fContainsNot/fBeginsWith/fEndsWith/fMoreThan/fLessThan/fEarlierThan/fLaterThan] -- how to compare the second value [second value reference] -- find String, or filetype, or creator, or size or whatever [add to found boolean] -- add the new results to the already found items, if any [start find boolean] -- if true, then start find process immediately. If false, just set the values and activate the Find window. [Result: integer] -- number of found items, or 0 if start find is false =========================================================== -- This is a short sample how to tell CDFinder to create catalog files of all local disks -- By Norbert M. Doerner 1999 tell application "Finder" set volumeList to every disk as list end tell tell application "CDFinder" repeat with oneDisk in volumeList set oneAlias to oneDisk as alias -- CDFinder needs an alias of the disk with timeout of 500 seconds -- remember: this might take more than the default 60 seconds! set myResult to create catalog of (oneAlias) -- use standard settings and do not update or duplicate end timeout if myResult = -128 then -- then the catalog might be already there end if end repeat end tell -- PLEASE NOTE: -- If you have any ideas or suggestions or even better, code samples, please tell me! -- Secret commands: -- By opening the preferences file, CDFinder will open the window to let you change the preferences. -- By opening any catalog file that is stored inside the catalog folder, CDFinder will open it -- and display its contents. -- These secret commands will go away once I figure out how to use properties and the -- get/set data commands. 
